home *** CD-ROM | disk | FTP | other *** search
/ Apple WWDC 1996 / WWDC96_1996 (CD).toast / Technology Materials / QuickTime VR / MacOS / QuickDraw™ 3D 1.0.6F4 SDK / Samples / SampleCode / View3DMF NetScape Plugin / README
Encoding:
Text File  |  1996-03-14  |  5.0 KB  |  94 lines  |  [TEXT/ttxt]
  1. //README - View3DMF Netscape Plug-in; version 1.0,  3/11/96
  2. //::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  3. //
  4. // Quickdraw 3D sample code
  5. //
  6. // Netscape plugin for displaying a stream of 3DMF data
  7. //
  8. // Rick Evans, AppleLink: DEVSUPPORT (devsupport@applelink.apple.com)
  9. //
  10. // ©1996 Apple Computer Inc., All Rights Reserved
  11. //
  12. //::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::::
  13.  
  14. View3DMF NetScape Plugin is an example of how to write a plug-in for the Netscape Navigator internet browser using QuickDraw™ 3D. It is basically a merge of two other samples:
  15.         ViewPict - the Netscape sample plugin
  16.         MetaFileRead - a QuickDraw™ 3D sample
  17.  
  18. The source code for the project has two significant files, which were copied from the original samples: 
  19.       View3DMF.cp - adapted from ViewPict.cp in of the Netscape sample
  20.       MetaFileView.cp - adapted from the MetaFileReadSupport.c
  21. It may be valuable to refer back to the original samples, if you have implementation questions.
  22.  
  23. --------------------------------------------
  24. To install the plugin:
  25. 1. Make an alias of the file Netscape Plugin (found in the View3DMF Plugin folder).
  26. 2. Move that alias to the Plugins folder found in the same folder as your Netscape Navigator* application. (Remove any other QD3D plugins such as WhurlPlug™ from this folder.)
  27.  
  28. To test the plugin:
  29. 1. Start Netscape Navigator.
  30. 2. From the Finder, drag the icon view3DMF_TestPage.html onto the Netscape Navigator window. An image of a three dimensional cross should appear and rotate.
  31.  
  32. Try viewing other World Wide Web sites that have 3DMF data; for example:
  33.  
  34.         http://product.apple.com/qd3d/QD3D.HTML
  35.  
  36. --------------------------------------------
  37. IMPORTANT: To compile this sample you will need the Netscape Mac Plug-in SDK 2.0, which can be download from:
  38.  
  39. http://home.netscape.com/comprod/development_partners/plugin_api/index.html
  40.  
  41. Download this folder and place it at the same level as the View3DMF Plugin folder
  42.  
  43. --------------------------------------------
  44. To compile the plugin (after downloading Netscape Mac Plug-in SDK 2.0):
  45. 1. Open the View3DMF
  46. 2a. Make the project or 
  47. 2b. (alternatively) enable the Debugger, and select the Debug command to build the project and start the debugger.
  48. 3. Test the plugin as described above. 
  49. (NOTE: the plugin must be correctly installed as describe above.)
  50.  
  51. *As of version 2 of the Netscape Plugin SDK for the Macintosh, to be enable the high level debugger the plugin must be name Netscape Plugin.
  52.  
  53. --------------------------------------------
  54. Requirments:
  55. Netscape 2.0 or later.
  56. PowerPC based Macintosh with System 7.5.1  (or later)
  57.     and the QuickDraw 3D extension (version 1.0.3 or later) 
  58.  
  59. --------------------------------------------
  60. This sample uses data in several folders and files:
  61.  
  62. CommonSample - source code used by many QuickDraw 3D samples
  63. Mac Plug-in SDK 2.0 - the Netscape Plugin Software Developer's Kit
  64. View3DMF Plugin - folder that holds the source code specific to this sample
  65. -    MetaFileView.cp - source code adapted from QuickDraw 3D sample MetaFileRead 
  66. -    MetaFileView.h
  67. -    Netscape Plugin - the plugin, copy an alias to the Netscape Plugin folder
  68. -    View3DMF.cp - source code adapted from Netscape plugin sample ViewPict
  69. -    View3DMF.h
  70. -    View3DMF.rsrc
  71. -    View3DMFPPC.µ - the MetroWerks CodeWarrior project
  72. -    View3DMFPPC.π - the Symantec C++ project (pending)
  73. -    View3DMFPPC.µ.exp - Metowerk's exported symbols files 
  74.  
  75. --------------------------------------------
  76. Known bugs: 
  77.  
  78. -Sometime when resizing the window, the View3DMF pane shrinks to a narrow pane about 5 pixels high at the upper left corner of the Netscape application window. This bug also appears in the ViewPict sample plug-in from Netscape's Mac Plug-in SDK 2.0. This bug is "fixed" by the idle time animation, but if you look closely after resizing the window (or if you disable the animation), you will see the shrunken pane. 
  79.  
  80. -Printing causes a crash. Avoid it, for now.
  81.  
  82. --------------------------------------------
  83. Future:
  84.  
  85. -I would like to clean up the sample by moving all the QuickDraw 3D ( ::Q3xxx() ) calls to MetaFileView.cp.
  86.  
  87. Other improvements left for the reader:
  88.  
  89. -Save file to disk: NPP_StreamAsFile()
  90. -Drag & Drop
  91. -Interaction with the model (i.e. grab, spin, zoom, etc.)
  92.  
  93. --------------------------------------------
  94. Disclaimer: This code is provided as an example of how I wrote a Netscape Navigator Plug-in that displays QuickDraw 3D images. It is provided to you to inspire and help you get started thinking about the issues of implementing a QuickDraw 3D Netscape PlugIn. I do not mean to impy it is the only way, nor the best way, to implement QuickDraw 3D PlugIn. Furthermore this sample has not underegone rigorous quality testing (nor, as of this writing, has it undergone a code review); there probably are bugs beyond what was reported above. There may even parts that are implemented incorrectly. If you find bugs or incorrect implementation, I would appreciate it, if you would point them out to me by sending e-mail to revans@apple.com.  Thank you.